Chapter 8. Tips and Techniques

Table of Contents
How to make a simple disk image
Use mtools to manipulate disk images
Bochs GNU/Linux DiskTools
Win32 only: Tools to manipulate disk images
X Windows: Color allocation problems
Screen saver turns on too quickly
Linux: Mounting a disk image using the loop device
Simulating a Symmetric Multiprocessor (SMP) Machine
Setting Up Networking in DLX Linux
Configuring and using a tuntap network interface
Using Bochs internal debugger
Using Bochs and the remote GDB stub
Using the serial port
Bios Tips
How to enter special key combination
Notes about VESA usage
Disk Image Modes
Using the bximage tool
Using the bxcommit tool

How to make a simple disk image

This was contributed by Greg Alexander in October 2001.

What you need:

Create a flat image

Option 1: Using the unix dd utility :

You will need to know the geometry of the disk you want to create. You have to compute the disk sector count :
Sectors = Cylinders * Heads * SectorsPerTrack

Use the dd command to create your file :
dd if=/dev/zero of=teaching.img bs=512 count=Sectors 
(replace Sectors with the number you computed at the previous step).

When you'll update your configuration file, please fill in the same cylinders, heads and sector per track values.

Option 2: Run `bximage` to create a disk image file. You will be greeted with the following prompt:
========================================================================
                                bximage
                  Disk Image Creation Tool for Bochs
========================================================================

Do you want to create a floppy disk image or a hard disk image?
Please type hd or fd. [hd] 

Since we are creating a hard disk image, accept the default of hd by pressing Enter or typing 'hd' and pressing Enter. Next bximage will ask for the type of hd to create :
What kind of image should I create?
Please type flat, sparse or growing. [flat] 

We want to create a simple flat image, so accept the default by pressing Enter. Then, bximage will ask for the size of the disk image you want to create, in Megabytes:
Enter the hard disk size in megabytes, between 1 and 32255
[10] 

Enter the size of the hard disk you want to create, and press Enter. Bochs will give you some information about the image it is creating, and ask you for a filename to use for the file it is creating. I told it to use the default of 10 megabytes, and was given the following information along with the prompt for a filename:
[10] 10

I will create a hard disk image with
  cyl=20
  heads=16
  sectors per track=63
  total sectors=20160
  total size=9.84 megabytes

What should I name the image?
[c.img] 

At this point, type in the filename you want to use for the image. The default of "c.img" is appropriate if this will be your only hard disk image. After you have typed in the name of the filename you want to use, press Enter. Bximage will tell you it is writing the disk and will display a status bar as you wait. When it is finished, it will give you a final status report and tell you a line that should be added to your .bochsrc file when you want to use this disk image. I named my 10 Megabyte image "teaching.img" and the output of bximage looked like this:
[c.img] teaching.img

Writing: [..........] Done.

I wrote 10321920 bytes to teaching.img.

The following line should appear in your bochsrc:
  diskc: file="teaching.img", cyl=20, heads=16, spt=63

At this point, a file called "teaching.img" was created in my current directory and is ready to be used as an image file for a bochs session.

Partition and format your image file.

Option 1: Using FreeDOS (Advantages: Creates a MBR on the partition.)

First, you need to edit the .bochsrc file that bochs uses for configuration information. Open the file .bochsrc with a text editor. Remove any lines in the file beginning with "diskc:". Add the "diskc:" line that was displayed when you ran bximage to the .bochsrc file in the same place that you removed the old "diskc:" lines from.

Also, you need to download or create a FreeDOS (or DOS, or Windows, or linux) disk image. Modify the "floppya:" line in your .bochsrc file to point at the downloaded FreeDOS image and change its status to "status=inserted".

Save and close your .bochsrc. Now run bochs. (see: "Running bochs from the command line.")

Use the standard FreeDOS commands fdisk and format to format your hard drive image. You must make the image bootable to be able to boot without a hard drive. However, creating a bootable disk image is best done with a boot disk from the OS you intend to install on the image.

Option 2: Using mtools (Disadvantages: cannot create bootable images without a MBR image)

Use a text editor to add the following line to the file ~/.mtoolsrc:

drive c: file="path/filename.img" partition=1

Save and close .mtoolsrc. Next, execute the following commands to create a partition table for the drive image:

mpartition -I -s spt -t cyl -h heads c:
mpartition -cpv -s spt -t cyl -h heads c:

For example, for my 10 meg drive, I used:
mpartition -I -s 63 -t 20 -h 16 c:
mpartition -cpv -s 63 -t 20 -h 16 c:

Next, format the partition you just created using the mformat command:
mformat c:

And you now have a formatted disk image containing a single DOS partition.